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AUTHOR’S ERNEST ENTREATY 

I have done my best to offer here a quality program at a reasonable 
price. This is my livelihood. Please do not make copies of this program 
for any reason other than personal backup. Thank you. 

INTRODUCTION 

Greetings fellow ATARI Home Computer owner. I am sure you are just 
as proud of your system as I am of mine? and enjoy buying accessories to 
extend its power and convenience. From that point of view, SUPERMON! is 
one of the most powerful additions you can make to your computer. Any 
serious ATARI owner will find it i ndi spensi b 1 e after using it for the 
first time. 


SUPERMON! is a resident machine language monitor which, once 
installed, is always available to you. What, that means is that you never 
have to load it and you can call it up no matter what program happens to 
be running at the time. Once running, SUPERMON! gives you complete 
control over your computer. This includes the ability to easily examine 
and modify memory or the 6502' s registers, to dump data to a printer, and 
to read and write to the disk drive(s) without DOS. It also has a 
complete set of debugging tools including a disassembler , single step, 
and a unique JSR function for testing out subroutines. And all of these 
features are available to you at any time, no matter what program is 

running, simply by pressing SYSTEM RESET along with either the OPTION or 
SELECT button! 

But. what if you are not an assembly language programmer? What if you 
just dabble in BASIC or maybe use your computer strictly for word 
processing? Even so, SUPERMON! can be worth its weight in gold as 
insurance against system crashes. By allowing you to save memory off to 
disk it can help you recover from glitches or operator errors. And if you 
have been wanting to learn assembly language programming, SUPERMON! can 
make it a very pleasant experience. Since it is ROM resident, you can 
usually get back to SUPERMON! even if your program goes berserk. You can 
even call SUPERMON! at critical points in your program to examine things 
before continuing execution. SUPERMON! is extremely user friendly so even 
programmers with little experience should find it very easy to use. 
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GETTING STARTED 

A -f t e r i n s t a 1 1 :i n g S l J P E R M G N ! :i n y o u r' c o m p u t e r < :i *f y o u h a v e n o t cl o n e 
so, see SIJPERMON! INSTALLATION INSTRUCTIONS) , you should be able to 
powerup your computer as usual . To enter the SLJPERNON! program, hold down 
t he OP T ION key an d p r e? s s SYS T E M RES E.' T * T h is me? t h o d o f e n t e r :i. n g S LJ P E R li 0 N ! 
w :i 1 1 c a u s e a w a r m star t u p t o t h e p o i n t t In a t t h e a p p 1 :i c a t :i o n p r o g r a m 
won Id n or ma 1 1 y b e g i ven c on t r o 1 - I n stead SUPER MON ! t a k es c on t r o 1 an d you 
s h o u 1 d s e e t. h e S U P E R M 0 N ! h e a d e r w r :i 1 1 e n a c r o s s t h e t o p o f t h e s c r e e n 
indicating that the program is runnings 

David Y o u n g S U P E R M 0 N ! C o p y r i g h t 1 9 8 3 
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When you are ready to exit SUPERMON ! , hold down the START button and type 
RETURN. This will cause the warmstart to go to completion, giving control 
back to the application program. Notice that pressing SYSTEM RESET by 
itself will cause a normal warmstart. 

Once you have SUPERMON! running, the first command to learn is the 
'‘HELP 1 ’ command. As is fairly standard practice in user friendly software, 
SUPERMON! uses "? r (RETURN) to give you a list of all the commands 
available. So type '?' followed by RETURN and you will see the followings 

CPU / CHS s C 

DPY/CHPsD (adr adr) 

EXECUTES E (byt) 

JSR sJ adr 
LINK DRs L (drive#) 

PRINTERS P 

RD DISKsR (sec# adr #) 

SEARCH sS adr byt. byt ... 

TOGGLE sT 

WR DISKs W (sec# adr #) 

DIS/CHGs X (adr adr) 

PSH STKs+ byt byt. ... 

POP STKs ~ 


The HELP command not. only provides a list of commands but also 
indicates the parameters each command expects. Parameters in parentheses 
are optional. If they are omitted, SUPERMON! will try to interpret the 
command in a manner convenient to you. Usually this means executing the 
command on the next, logical memory location or sector. If you are anxious 
to start using SUPERMON!, you can do so immediately with just this lttle 
bit. of knowledge. With a little experimentation you should have little 
trouble figuring out what most of the commands do. When you are ready to 
learn some of the more subtle features built into SUPERMON!, read the 
rest of this documentation. 
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There are a few important things to point out before proceedings 


i) All numerical input and output is done in h 


ex . 


2) Parameters are delimited toy a space or other non-hex character. 

3) The command toeing processed will be aborted if an illegal parameter is 
encountered or if a necessary parameter is not supplied. 

4) It is not necessary to retype a command if it is already present on 
the screen. Just position the cursor on the same line, make changes if 

you wish., and type RETURN. All the normal ATARI editing commands are 
avai 1 abl e. 

5) The processing of most commands can toe stopped toy holding down the 
START button. This allows you to terminate a long listing, search or 
single step. 

DISPLAY MEMORY: D (start addr) (end addr) 

lhis command is used to view data in memory in either hex or 
character format, depending on the current data format, (see TOGGLE). In 
hex format the data is output to the screen as 1 or more lines of 8 hex 
toytes separated by spaces. In character format the data is output as 1 or 

more lines of 24 byte character strings. On each line, the address of the 
first byte precedes the data. 

In either data format, the letter 'A' is appended to the start of 
each line. This in fact represents the ALTER MEMORY command (see the 
following command description). The effect is that, once you have used 
"D” to display part of memory, you can alter any byte(s) by simply 
positioning the cursor, typing the change(s), and hitting RETURN. You 
must type RETURN on each line that you alter for the change to take 
effect. Also, the current data format must match the way the data was 
represented on the line. One other limitation in the character mode is 
that a line containing the character representing $9B is not alterable 
past that character. The OS cannot handle a record with an imbedded <|>9B. 

If y° u wish to alter a line after a $9B character, redisplay the line 
starting just past the character. 

To display memory, type 9 D 9 followed by optional start and stop 
addresses and then RETURN. If you omit the stop address, only a single 
line of data will be printed. If you omit the start address, the next 
logical line of data will be printed (either the next 8 or 24 bytes of 
memory, depending on the data format). One last convenience is that once 
you have used the 9 D 9 command, SUPERMON ! will default to that, command if 
you just type RETURN. This allows you to scroll through memory by holding 
down the RETURN key. This default will remain in effect until one of the 

other 'persistent 9 commands (R or X) are used, at which time they will 
become the default. 
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TOGGLE DATA FORMAT: T 

As mentioned previously, all numerical data is represented in hex. 
However, when dealing with ASCII text it is more convenient to work in 
character format. The TOGGLE command <T> is used to switch between hex 
and character -format. It a-f-fects three commands: ALTER MEMORY (A), 
DISPLAY MEMORY (D) and SEARCH MEMORY (S) . Other commands are unaffected 
by the current data format. 


To switch data formats type 'T' (RETURN). Upon first entering 
SIJPERMON! the data type defaults to hex. 


ALTER MEMORY: A addr byte byte 


II 19 * 


This command is used to change 1 or more contiguous bytes of memory. 
You can type the change either as hex bytes (separated by spaces) or as 
ATASCII character strings, depending on the current data format (see 
TOGGLE). While it is possible to use the 'A' command by itself at any 
time, it is not recommended. To display the area of memory first, with 
the 'D' command and then to position the cursor and make the change is 
much safer (see DISPLAY MEMORY). This way you not only verify that the 
memory at that location is the memory you intended to change, but also 
that the current data format, is compatible with the data you are typing. 

To use the ALTER MEMORY command, type 'A' followed by an address. 

Use a space to separate the address and the data and then start typing 
the data. If in hex format, type hex bytes delimited by spaces. If in 
character format, type a continuous character string. Terminate the 
command with RETURN. At that point the indicated changes will be made. 

The command line can be as long as you like or until the computer 
squawks. SQUAWK! 

SEARCH MEMORY: S addr byte byte . . . 

Searching is something that computers do very well and SUPERMON ! has 
a very nice search function that works in either hex or character mode. 

It will scan memory for any sequence you specify and display it in a 
manner similar to the DISPLAY MEMORY command every time it is found. This 
means you can alter any occurrence of that sequence by simply positioning 
the cursor, typing the change and hitting RETURN (see DISPLAY MEMORY). 

Even though it only takes a few seconds to search all of memory, a 
search can be aborted by holding down the START button. The search can 
then be resumed where it left off by typing ’ S (RETURN)' but only if 
there have been no intervening commands. 

To use the SEARCH MEMORY command, type 'S' followed by the address 
where you would like the search to begin. Then type a space followed by 
the search sequence. This will be hex bytes separated by spaces in hex 
mode or a character string in character mode (see TOGGLE). The search 
will begin when you hit RETURN. The search sequence can be any length up 
to the limit of the ATARI terminal input buffer (squawk). 
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PRINTER ON /OFF : P 

If you want a hardcopy record of your SUPERMON! session, you can use 
the 'P' command to cause anything being output to the screen to foe echoed 
to the printer. In character mode, inverse video characters are printed 
as normal video and unprintable characters are translated to dashes ( -- ) . 
Otherwise, everything on the screen will show up on the printer. There is 
even a special single step mode (see EXECUTE) that will trace through a 
program while outputting only to the printer and not to the screen. This 
is useful for programs that use the screen in modes other than GRAPHICS 0. 

The 'P' commmand is a toggle function. Typing it once will enable 
output to the printer and typing it again will disable output. If the 
printer is not turned on or selected, the message 'I/O ERROR' will 
result. Care should taken if the printer is enabled while reading or 
writing to the disk (see READ DISK or WRITE TO DISK). 

DISK INPUT/OUTPUT 

Anyone who owns my disk utility DISKSCAN knows how useful it is to 
be able to edit raw sector data on a disk. One of my goals in designing 
SUPERMON! was to incorporate a simple disk interface which, while not. 
being as powerful and easy to use as DISKSCAN, would allow you to do many 
of the simple tasks which often crop up. Imagine, a resident 
mini -DISKSCAN! 

Well, the end result has far exceeded my expectations. With 
SUPERMON! you can not only read and write individual sectors, but 
multiple sectors to and from anywhere in memory. And it. not. only works in 
sequential mode, but it can also follow sector links. In fact, you caxn 
read in an entire DOS file from a disk without even booting up DOS! And 
the frosting on the cake is that SUPERMON! works equally well in single 
or double density, a dream come true for the growing number of double 
density drive owners. 

LINK/SEQ MODE & DRIVE #s L (drive#) 


When you first enter SUPERMON!, the program assumes that you wish to 
talk to drive #1 and that, the sector mode is sequential. If you wish to 
talk to other drives or follow sector links, use the LINK command to put 
SUPERMON! in the correct mode. The LINK command is actually two commands 
in one. When used by itself (without a parameter) 'L' means to toggle 
from sequential to linked mode or vice versa. When followed by a drive # 

(1-4), 'L' means to switch the drive ID to the specified drive. From that 

point, on, all disk I/O will be directed to that drive. 

To toggle between the sequential and linked sector modes, type 'L 
(RETURN) '.To direct disk I/O to a different drive, type 'L' followed by 
the drive # and RETURN. 
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REA D D I S K s R ( s e c t o r # ) ( b u f f e r a d c:l r ) ( # s e e t o r s ) 

T I* ) e R E A D D I S K c o rn m a n d i s o n 0 o f t h 0 m o s t p a w 0 r f (. 1 1 , u s 0 r f r :i. e n d 1 y 
•functions of SUPERMGN ! . It can be used to read one or more sector s , 
e i t h er s e q u e n t i a I 1 y o r 1 i n k 0 d , f r o m a n y d i s k d r ive, s :i. n g 1 e o r d o u h 1 0 

d e n s i t y - We w i 1 1 s t a r t o u t b y u s i n g t h e R E A D I) 3.‘ S K c o m m a n d t o r e a d o n 0 

sector at a time. You will find it behaves somewhat differently when 
operating on more t h an on e sec t or at a t i me . 

T o r e a d a s i n g 1 e s e e t o r i n t o m e m o r y t y p e R *f o I 1 o w e d b y t h e s e c t o r 

# and RETURN. SUPERMGN! will assume a buffer address of $6000 unless you 
s p e c i f y s o m e t h i n g d i f f e r e n t a f t e r t h e s e c t o r # . F r o m t h a t p o i n t o n 
SUPERMGN ! will assume that new buffer address for subsequent disk I/O. 

Once you have the sector in memory you can operate on it with any of the 
other SUPERMGN ! commands including D I SPLAY , ALTER, SEARCH, DISASSEMBLE , 
etc. G n & c o n v e n i e n t f e a t u r e i s t h a t , a f t e r a R E A D D 1 S K c o m m a n d , S U P E R M 0 N ! 

will as s u me the b u f f e r a d d r ess if you u s e ' D ' o r X w i t h o u t a s t a r t 

a d d r e s s . < T r y t: y p i n g ' D < R E T U R N ) a f t e r r e a d i n g a s e e t o r i n t o m e m o r y ) . 

Now, if you wish to read the sector which logically follows the last 
sector read into memory, type ' R (RETURN)'. In sequential mode, the next 
physical sector on the disk will be read. In linked mode, SUPERMGN! will 
referenc e t he se c t or 1 i n k o f t h e c u r r e n t s e c t o r t o d e t e r m i n e t h e n e x t 
sector to read. In either case, the new sector will be read into memory 
at the SAME buffer address, overlaying the old sector. 

NOTES IF THE PRINTER IS ENABLED WHILE READING SINGLE SECTORS, THE SECTOR 

# AND BUFFER ADDRESS MUST BE SPECIFIED EACH TIME. This is because the 
printer and disk share the SIG DCS (Device Control Block). 

R e a d y f o r a c o u p 1 e m o r e e x a m p J. e s o f u s e r f r i e n d 1 i n e s s ? 0 n e i s t h a t 
the "R 1 ' command, like 'D' and ? X , is a 'persistent' command. That means 
that one e y o u u s e t h e R c o m m a n d , S U P E R M □ N ! w i 1 1 d e f a u 1 1 t o t h a t c o m m a n d 
if you just type RETURN. This default will remain in effect until one of 
the other persistent commands are used. What this means is that you can 
read through an entire file (or disk, if in sequential mode) by reading 
the first s e c t o r a n d t h e n s i m p 1 y h o 1 d i n g d o w n t h e R E T U R N k e y . G n e o t h e r 
convenience is that SUPERMGN! will not read past the end of file if it is 
in linked mode. Thus, if you were reading through a file as suggested 
above, simply hold down the RETURN key until 'EOF 1 *' is printed. At that 
p o i n t , t h e last s e c t o r o f t h e f i 1 e i s a t t h e b u f f e r a d d r e s s . Y o u ar e f r e eVp 
to add something to the end of t h e file ( p er h ap s an aut or un vec t or ) ai 1 u 
then to write the sector back out with the WRITE SECTOR command. 



Reading multiple sectors is somewhat different from reading single 
sectors. For one thing, the sector #, buffer address, and sector count 
must be specified each time. The other difference is that, instead of 
consecutive sectors overlaying each other, the buffer address is 
incremented between sectors so that the disk data fills memory. The exact 
amount by which the buffer address is incremented depends on the sector 
mode and the density of the drive?. The effect is that in sequential mode 
all bytes of the sector are preserved, while in linked mode the sector 
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links are overlayed. This is a desirable feature if you want to read an 
entire DOS 'file into memory. If you find this discussion con-fusing, it is 
recommended that you read my tutorial on ATARI DISK DATA STRUCTURES in 
the DISKSCAN USER’S GUIDE or the MARCH 1982 issue o-f COMPUTE! magazine. 

An example may be o-f help. First, put SUPERMON! in character mode 
with ’ T’ and sequential mode with ’L’. Now type ’ R 169 6000 8’. This will 
read in the 8 sectors of the directory into the buffer at *6000. Now type 
’D’ followed by several RETURNS. You will be able to read the names of 
the files on the disk. Choose a filename, put SUPERMON! in hex mode with 
’T’, and use ’D addr’ to display the 5 bytes just prior to the filename. 
The first byte is the status while the next two are the size of the file 
and the next two are the start sector. Now put the program in linked mode 
with ’L’. Read in the entire file with ’R (start sector) 6000 (file 
size)’. Type ’D’ and hold down the RETURN key to scroll through the data 
of the file. 

If the file happens to be a BINARY LOAD file, a slight variation of 
this technique is recommended. Instead of specifying an arbitrary buffer 
address of *6000, look at. the first sector of the file to determine the 
load address. Then subtract 6 bytes to account for the load vector and 
use that number as the buffer address. Then, after the file is loaded, it 
can be executed, searched, disassembled or otherwise manipulated to your 
hearts content. Notice that the* entire program will be loaded to the 
correct place in memory only if there is but one load vector at the 
beginning of the file. SUPERMON! as a rule ignores load vectors. If you 
must load a file with multiple load vectors, use DOS. 

One final convenience is that each time a sector is read, its # is 
printed along with the buffer address. Thus, when you read in an entire 
file as in the exercise above, you get a sector map of that file. It is 
safe to have the printer on during this process to get a hardcopy of the 
sector map, but it is best to turn it. off during other DISK I/O 
operations for the reason mentioned above. Now if, while inspecting the 
file in memory, you find that you wish to make a change to the file on 
disk, you can compare the buffer address to the sector map of the file to 
determine the sector where that piece of data resides. Then you can use 

’R sec#’ to fetch that sector, make the change, and use ’W sec#’ to store 
the sector back on disk. 


• MU 
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WRITE TO DISKs W (sector #) (buffer a cl dr) (# sectors) 

The W R I T E T 0 D I S K c: o m m a n d a 1 1 o w s y o la t o w r i t e o n e o r m o r e s e c t o r s 
wort h o f mem o r y o u t t o d i s k . T h e o n e Id :i. g d i *f f e r e n c e b e t w e e n i t and t h e 
READ DISK command is that it only works in the sequential mode. That 
means that it will not create a DOS -file,, i « e * ,, it will create neither a 
directory entry nor sector links. If you do wish to create a DOS -file oui J A 
of memory it is best to use the BINARY SAVE option of DOS. However, it i 
n o t always p o s s i b 1 e t o g e t D 0 S i id t o m e m o r y w i t h o u t 1 o s i n g y o u r d a t a * I n 
this case, SUPERMQN ! may be the only way save your data* If you do wish 
t o o reate a D 0 S f i 1 e o u t o f t h e m e m o r y y o u Id a v e w r i 1 1 e n t o d i s k w i t h 
SUPERMQN!, use the BINARY LOAD FILE -function of DISKSCAN in the 
s e q u e n t i a 1 m o d e * This -f e a t u r e o f D I S K S G AN will pi c k u p s e c t o r s a n d 
redeposit: them as a DQS -file* 

IMPORTANTs Use a scratch disk when writing multiple sectors worth of 
memory to disk with SUPERMQN!* The program pays no attention to data 
already on the disk and may overlay it* 

T h e pr i mar y p la r p ose of the W R I T E T 0 D I S K c a m m a n d is t o s la p p o r t t h e 
modification of one sector at a time. A typical scenario is as foil owes 

Read a file into memory as described in READ DISK* 

8 earc h t h e f i 1 e t o f i n d t h e d a t a t o b e c Id a n g e d „ 

Compare the address of the data in memory to the 
sector map created while the file was being read in* 

Read that particular sector into memory with * R 
sec# * T h is in s u res t hat y o u n o t a n 1 y h a v e t h e d a t a 
of the sector bLAt also the sector link* Then alter 
the sector and write it back out with 51 W sec#’. 


Another application for the WRITE TO DISK command would be to move a 
block of memor y from one 1 oc at i on t o an o t h er « Th i s i s ac c omp 1 i sh ed b y 
writing the data out from one bLAffer address and reading it back in at 
another* It is important to use a scratch disk for this operation or at 
least be very careful that yoLA are writing to an unused portion of a disk 
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ADVANCED TOOLS 

We have seen how to enter SUPERMON! by holding down OPTION and 
pressing SYSTEM RESET. This causes a normal warmstart followed by a jump 
subr out i ne (JSR) to SUPERMON! . When you exit SUPERMON! after entering j t 
in this way (by holding down SI ART and pressing RETURN) , the warmstart 
goes to completion in a normal fashion. This is fine for some 

applications but there is actually a better way to enter SUPERMON ! which 
disturbs the program running as little as possible. 

When you hold down SEL..EC1 and press SYS1EM RESET, the program 
running at the time is interrupted. However, instead of doing the entire 
warmstart, parts of it. are skipped over so as to preserve the state of 
the system as much as possible. Specifically, the OS variables and the 
stack are left, undisturbed. Usually this allows you to reenter the 
program by simply exiting SUPERMON! in the normal fashion. For instance 

you can pop into SUPERMON! from either DOS or BASIC, execute some ’ 

SUPERMON! commands, and pop back into the interrupted program almost as 
it you had never left it. I say " almost' because the OS is likely to 
return a bogus value if it was waiting for a keystroke when it was 
interrupted. For that reason it is best to hit BREAK upon return to the 

MnnJ r « m ‘ C ° Ur f e , ! ' 1 f the program makes use of any graphics other than 
MODE 0, it. is unlikely that you will be able to sucessfully reenter the 
program without restarting it. This is also true of programs which alter 

the interrupt RAM vectors ($200~$224> because SUPERMON! restores them to 
their original values. 

Another way to enter SUPERMON! is particularly useful for debugging 
assembly language programs. This is accompli shed by putting “JSR #0001'“ 
at. critical points within the program. At each of these points SUPERMON! 
wi 1 1 be entered and you will have all of its facilities available for 
examining the intermediate results of your program. When you are ready to 
continue executing your program, .just exit. SUPERMON! with START/RETURN. " 
Ihere are some restrictions on this technique however, specifically 
special graphics and time critical I/O. 

Yet another way to enter SUPERMON! is from BASIC with a 

■ X=USR (32768) 5 . In fact, this is the recommended way to enter the monitor 
if you have not modified the interrupt vectors at $FFFA~-il;FP"FD as 
described in the SUPERMON! INSTALLATION INSTRUCTIONS. You can exit back 
to BASIC in the usual manner (START/RETURN). 


It. should also be pointed out that SUPERMON! will be entered 
automatically if a 6502 BRK instruction (0) is ever executed. Thus, you 
can set a breakpoint anywhere in your program by storinq a 0. When vou 
pop into SUPERMON! after executing a BRK instruction, you should restore 

the original instruction and subtract 2 from the PC. Now you can continue 
executing your code when you exit. SUPERMON!. 
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CPU REGISTERS: C 


You will notice that, upon entering SUPERMON!, the 6502’ s internal 
registers are printed out with the following heading: 

PC NV-BDIZC ACCUM X-REG Y---REG STACK 

The meanings of these headings are self-explanatory except for 
•’NV-BDIZC’. These are the Individual bits o-f the status register spelled 
out. Thus, this is a snapshot o-f the state of the CPU just prior to 
entering SUPERMON!. The PC (program counter) is pointing to the next 
instruction to be executed. The program will continue executing at this 
point when you leave SUPERMON! with SI AR1 /RET URN. 

The CPU state can be examined at any time with the CPU REGISTERS 
command ’C’. In addition, the CPU state can be changed by simply 
positioning the cursor over the value, typing the change, and hitting 
RETURN. The new values for the registers will be in effect when you leave 
SUPERMON! to resume execution of the suspended program. The only CPU 
register that cannot be changed directly is the stack pointer. This can 
be changed only by the PUSH STACK ( + ) and POP STACK (—) commands. 

One application for the ’C’ command is to GOTO anyplace in memory. 
This is accomplished by altering the PC to point to the address where you 
wish execution to resume when you press START/RETURN. Typically this 
might be back to DOS, whose address can usually be found by looking in 
location $000A (DOSVEC) . 

Another area of interest is the stack. Remember, the stack pointer 
always points to the next FREE entry. All the values between the stack 
pointer and S1FF are typically return addresses of nested subroutine 
calls. This, in fact, is a vertical cross section of the execution 
history of the program. This is extremely useful for finding your way 
around in a program you wish to modify in some way. If you wish to to 
locate the part of a program which is performing a certain function, just 
start the program executing that function and press SELECT/RESET. Because 
the stack is preserved with this method of entering SUPERMON!, you can 
tell where the program is and where it has been by noting the PC and the 
return addresses on the stack. Another way of locating a certain piece w, 
code is to search (’S’) for a particular address it might reference. 


r 1 
L J 


r 1 
L A 
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PUSH STACK: + byte byte? 


M N If 


The PUSH STACK command is -for adding bytes to the stack and thereby 
increasing the stack pointer (which grows downward in the 6502)- These 
bytes will be available to the code pointed to by the PC when SUPERMON ! 
is exited. Notice that the first byte after ’+’ is the first one to be 
pushed onto the stack. 


Please note that the stack pointer displayed with the ’C’ command is 
not the ACTUAL stack pointer while SUPERMON! is running. SUPERMON! uses 
the stack for its own purposes and is actually nested somewhat deeper. It 
is not wise to make changes directly to the stack unless you use PUSH 
STACK or POP STACK. Even then you must, be careful not to cause the stack 
to overflow or underflow. 


POP STACK : - 

The POP STACK command takes bytes off of the stack one at a time and 
decreases the stack pointer (which actually increases in value). Be 
careful to not cause the stack to underflow. 

DISASSEMBLE MEMORY: X (start addr) (stop addr) 

Just as it is possible to display memory in hex or character format, 
it is also possible to translate 6502 machine code to assembly language. 
SUPERMON! does this in a handy fashion by printing out the object code 
along with the instruction. Once again, it is possible to change the 
object code (to the left of ’He’ ) by positioning the cursor, typing the 
change, and hitting RETURN. Another convenience is that the value at the 
address specified with indirect addressing modes is printed in 
parentheses. 


Just like the ’R’ and ’D’ commands, ’X’ is ’persistent’. Once you 
have disassembled one or more instructions, you can continue 
disassembling simply by holding down RETURN. This will remain in effect 
until ’R’ or 'D" are used. The disassembler can be aborted at any time 
pressing the START button. 


Im# 
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EXECUTE MEMORY : E (option/# steps) 

The EXECUTE MEMORY command is actually a single step command in 
disguise (’S’ is used for SEARCH). This command causes the instruction 
pointed to by the PC to be executed. Then the registers are printed out 
along with the NEXT instruction to be executed. If the step count was 1 
(or not specified) then execution will stop. Otherwise it will continue 
single stepping through the code for the specified # steps. The maximum 
number of steps is 31 for reasons soon to become clear. 

While the low order 5 bits of the optional parameter are a step 
count, the high order 3 bits have special meaning. The MSB means ’step 
forever’. Thus, ’E 80’ means ’step forever and print the trace to the 
screen’. Notice that the trace will also be echoed to the printer if it 
is enabled. Stepping can be aborted by pressing START. 

Bit 6 of the parameter means ’don’t print the trace to the screen’ . 
However, the trace will still be output to the printer if it is enabled. 
Thus, ’E C0’ would step forever without printing the trace to the screen 
In combination with the printer this is useful for stepping through 
programs which use special graphics modes. 

Bit 5 of the parameter means ’sample the results of every 32 
instructions’. Thus, ' E E0’ would step forever without printing to the 
screen and the trace would be output to the printer every ..s2nd 
instruction (if it is enabled). This is kind of a wierd mode, but 
somebody may find a use for it someday. 

One other nice feature of the ’E’ command is that it will treat a 
call to the OS as a single instruction instead of stepping through all 
the code in the OS. SUPERMON! does this by temporarily giving up control 
of the CPU but intercepting it on the return from the OS. However, you 
should avoid stepping through CIO calls to the screen editor (Es ) unless 
printing to the screen is disabled with bit 6. SUPERMON! considers any 
address above $C000 to be OS. 

We have seen that the EXECUTE MEMORY command is very powerful and 
flexible. One restricion, however, is that it. will not step through a 
’SEI’ instruction. If you are stepping through a program and encounter a 
SEI , disassemble on past it to find the ’CLI’. Just, past the CLI put a 
temporary BRK instruction (0). Now step through the SEI. SUPERMON! will 
temporarily lose control of the program but will regain it when the BRK 
instruction is executed. Now restore the original value to the location 
where the BRK. was set. After subtracting 2 from the PC you are ready to 
continue stepping. 

SUPERMON! makes use of the SIO interrupt routines in the OS ROM by 
altering the interrupt vectors at *20A--*20D . This is so the printer and 
disk interface of SUPERMON! will work even if DOS is not in memory. If 
you wish DOS to restore its special vectors, exit SUPERMON ! with SYSTEM 
RESET. I have noticed no difference in DOS’ behavior with the ROM SIO 
handlers installed. 
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JSR: J addr 

The JSR command is a very powerful feature for executing a 

subroutine and returning control back to SUPERMON!. It can be used for 

testing out subroutines during the development of an assembly language 

program. With some care it can also be used to call the OS to sav J 
format a disk. ' ’ Y ’ 

When you execute the ’ J ’ command you will notice that the registers 
are printed out but that the subroutine is not yet executed. In fact, the 
J' command does nothing more than change the PC to the specified address 
and push the address of SUPERMON! on the stack to act as the return 

ral^hv S i b h rOUtine ; N ° W Y ° U are * ree to set >- l P the subroutine 

.all by altering the registers or memory if necessary. When you are ready 

to actually execute the subroutine press START/RETURN. Upon return you 

will notice that the PC is restored to its original value but that the 

other registers reflect the results of the subroutine. 

As an example, put a fresh disk (or one you don’t mind formatting) 
-,^ riVe *’ Wlth the printer disabled, store a 1 in *301 and a *21 in 

Now e>!ecu te a ’J E453’ and press START/RETURN. The disk in drive 1 
will be formatted and then control will be returned to SUPERMON!. 

. Sometimes after interrupting a program with SUPERMON!, you will not. 

be able to restart it without reinitializing it. The start and 
initialization addresses for a program are typically at *000A and *0000 
respectively. Since a proper initialization routine is always a 
subroutine, you can use ’J (irtit addr)’ to initialize the program. When 
control returns to SUPERMON!, you need only change the PC to the start 
address and exit SUPERMON! with START/RETURN to restart the program. 

QUESTIONS? 

I welcome? comments, suggestions and dealer inquiries, 

DAVID YOUNG 
CDY CONSULTING 
421 HANBEE 

RICHARDSON, TX 75080 
LIMITED WARRANTY 

f-or a period of one year following the date of purchase CDY 
CONSULTING will repair or replace any SUPERMON! unit, proven to be 
defective. PI ease return the defective unit to the place of purchase. 
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SIJPERMON ! I NST ALLAT I ON I NSTRUCT I ONS 

Thp SIJPERMON 1 proqram comes in a 2732 EPROM. This can foe installed only 
in soecial hardware such «. RAMROD MMOS by NEWELL INDUSTRIES which accept. . 
2732 in the *0000 block of memory. Fallow the instructions provided wt > .nr 

hardware •for i nstal 1 i on of t. ho chip* 

Now power up the system to make sure the installation 1 ® ‘^prRMON , U ? r -nm 
ooint It everything appears to be normal, try entering bUPERMON! Iim 
BASir P with"a * X*1 )SrT^ 9/5T2) ' . It it -fails this test then double check the 
illation of the chip. It this works properly then proceed with the next 

paragraph „ 

For pr ope r o p e r a t. i o n o f B U P E R MON ! t he *f o 1 .1 o w i n g .1. o c a t. ion s sho u i d b e 
changed in the OS (assuming your OS is in EPROMS): 

$FF FA-UF'FFD - > $CE , SCF , SF5 , SCF 

This allows the SELECT and OPTION keys to work in conjunction with SYSTEM ^ 
RESET tor entering SUPERMON ! . It you do not make this mod then it. is possible 
to enter SIJPERMON 1 trom BASIC with ’ X“USR (32768) ’ • However, this is less 
convenient than the SELECT/RESET or OPTION/RESET technique, which interrupts 

any program which may be running* 

It the system tails to power up a-f-ter you have? made these mods then the 
mods were not. done correctly. When done correctly the system should power up 
normally and you should toe able to enter SUPERMON! with SELECT /RESE1 or 
OPTION/RESET. Installation ot SUPERMON! is now complete. 




